iT邦幫忙

2025 iThome 鐵人賽

DAY 21
0
自我挑戰組

Git 與 GitHub 入門日誌系列 第 21

Day 21:Git Tag 與 Release

  • 分享至 

  • xImage
  •  

到目前為止,
我們已經學會了 commit、branch 與合併專案。
今天要進一步學習 如何替專案「打版本標記」,並在 GitHub 上建立 Release。
這對於開發流程很重要,因為每個 milestone(如 v1.0、v2.0)都可以被清楚記錄。


Tag

Tag 就像是給某個 commit 貼上一個「標籤」,
常用來標記專案的重要版本,例如:

  • v1.0 → 第一個正式版本
  • v1.1 → 修正小 bug
  • v2.0 → 加入重大新功能
    這樣團隊或使用者就能快速找到穩定版本,而不用在眾多 commit 中迷路。

Release

Release 是 GitHub 上比 Tag 更進一步的功能,
它會根據某個 Tag,產生一個版本頁面,
在這裡你可以:

  • 撰寫版本說明(release notes)
  • 提供程式壓縮檔下載(zip、tar.gz)
  • 公告這個版本的功能與變更

步驟 1:建立一個 Tag
先確認你在專案的主分支:

git checkout main

建立一個標籤(假設要標記版本 v1.0):

git tag v1.0

這樣就會在最新的 commit 上打上 v1.0 的標籤。

步驟 2:將 Tag 推送到 GitHub

git push origin v1.0

這樣 GitHub 上就會看到 v1.0 的版本標籤。

步驟 3:查看目前有哪些 Tag

git tag

輸出範例會如下圖:
https://ithelp.ithome.com.tw/upload/images/20251001/20169195cHJmzQJaNl.png

步驟 4:在 GitHub 上建立 Release
到 GitHub 專案頁面,
在右邊欄位有一個 Releases,我們點選它。
https://ithelp.ithome.com.tw/upload/images/20251001/20169195qpNgbmupYS.png

接著點 Create new realeases。
https://ithelp.ithome.com.tw/upload/images/20251001/20169195Aya7xklqA0.png

選擇剛才推送的 v1.0 Tag
https://ithelp.ithome.com.tw/upload/images/20251001/20169195IUTqbP7V7o.png

填寫 Release 標題(例如:v1.0 初始版本),
並在說明區寫版本更新內容,
按下 Publish release,就完成囉~~~
https://ithelp.ithome.com.tw/upload/images/20251001/20169195kRl8GxywOy.png


今日學習收穫許多,
除了了解 Tag 的用途:為重要的 commit 打上版本,
還學會在 GitHub 上發布 Release,
開始管理專案的版本歷史,方便未來維護與分享!


上一篇
Day 20:使用 Issue 與 Project 管理任務
下一篇
Day 22:GitHub Pages 基礎
系列文
Git 與 GitHub 入門日誌24
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言